home *** CD-ROM | disk | FTP | other *** search
/ Skunkware 5 / Skunkware 5.iso / man / cat.3 / GeomReq.3 < prev    next >
Encoding:
Text File  |  1995-07-26  |  6.0 KB  |  133 lines
  1.  
  2.  
  3.  
  4.      TTTTkkkk____GGGGeeeeoooommmmeeeettttrrrryyyyRRRReeeeqqqquuuueeeesssstttt((((3333))))        TTTTkkkk (((( ))))         TTTTkkkk____GGGGeeeeoooommmmeeeettttrrrryyyyRRRReeeeqqqquuuueeeesssstttt((((3333))))
  5.  
  6.  
  7.  
  8.      _________________________________________________________________
  9.  
  10.      NNNNAAAAMMMMEEEE
  11.           Tk_GeometryRequest, Tk_SetInternalBorder -  specify  desired
  12.           geometry or internal border for a window
  13.  
  14.      SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  15.           ####iiiinnnncccclllluuuuddddeeee <<<<ttttkkkk....hhhh>>>>
  16.  
  17.           TTTTkkkk____GGGGeeeeoooommmmeeeettttrrrryyyyRRRReeeeqqqquuuueeeesssstttt(_t_k_w_i_n, _r_e_q_W_i_d_t_h, _r_e_q_H_e_i_g_h_t)
  18.  
  19.           TTTTkkkk____SSSSeeeettttIIIInnnntttteeeerrrrnnnnaaaallllBBBBoooorrrrddddeeeerrrr(_t_k_w_i_n, _w_i_d_t_h)
  20.  
  21.      AAAARRRRGGGGUUUUMMMMEEEENNNNTTTTSSSS
  22.           Tk_Window    _t_k_w_i_n        (in)      Window     for     which
  23.                                               geometry     is    being
  24.                                               requested.
  25.  
  26.           int          _r_e_q_W_i_d_t_h     (in)      Desired width for _t_k_w_i_n,
  27.                                               in pixel units.
  28.  
  29.           int          _r_e_q_H_e_i_g_h_t    (in)      Desired    height    for
  30.                                               _t_k_w_i_n, in pixel units.
  31.  
  32.           int          _w_i_d_t_h        (in)      Space   to   leave   for
  33.                                               internal    border   for
  34.                                               _t_k_w_i_n, in pixel units.
  35.      _________________________________________________________________
  36.  
  37.  
  38.      DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  39.           TTTTkkkk____GGGGeeeeoooommmmeeeettttrrrryyyyRRRReeeeqqqquuuueeeesssstttt is called by widget code to indicate  its
  40.           preference  for  the dimensions of a particular window.  The
  41.           arguments to TTTTkkkk____GGGGeeeeoooommmmeeeettttrrrryyyyRRRReeeeqqqquuuueeeesssstttt are made  available  to  the
  42.           geometry  manager  for the window, which then decides on the
  43.           actual geometry for the window.  Although geometry  managers
  44.           generally     try    to    satisfy    requests    made    to
  45.           TTTTkkkk____GGGGeeeeoooommmmeeeettttrrrryyyyRRRReeeeqqqquuuueeeesssstttt, there is no  guarantee  that  this  will
  46.           always  be  possible.   Widget code should not assume that a
  47.           geometry request will  be  satisfied  until  it  receives  a
  48.           CCCCoooonnnnffffiiiigggguuuurrrreeeeNNNNoooottttiiiiffffyyyy  event  indicating  that the geometry change
  49.           has occurred.  Widget code should never call procedures like
  50.           TTTTkkkk____RRRReeeessssiiiizzzzeeeeWWWWiiiinnnnddddoooowwww   directly.    Instead,   it  should  invoke
  51.           TTTTkkkk____GGGGeeeeoooommmmeeeettttrrrryyyyRRRReeeeqqqquuuueeeesssstttt and leave the final geometry decisions to
  52.           the geometry manager.
  53.  
  54.           If  _t_k_w_i_n  is  a  top-level  window,   then   the   geometry
  55.           information  will  be passed to the window manager using the
  56.           standard ICCCM protocol.
  57.  
  58.           TTTTkkkk____SSSSeeeettttIIIInnnntttteeeerrrrnnnnaaaallllBBBBoooorrrrddddeeeerrrr is called by widget  code  to  indicate
  59.           that the widget has an internal border.  This means that the
  60.  
  61.  
  62.  
  63.      Page 1                                          (printed 7/23/95)
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.      TTTTkkkk____GGGGeeeeoooommmmeeeettttrrrryyyyRRRReeeeqqqquuuueeeesssstttt((((3333))))        TTTTkkkk (((( ))))         TTTTkkkk____GGGGeeeeoooommmmeeeettttrrrryyyyRRRReeeeqqqquuuueeeesssstttt((((3333))))
  71.  
  72.  
  73.  
  74.           widget draws a decorative border inside the  window  instead
  75.           of  using  the standard X borders, which are external to the
  76.           window's area.  For example, internal borders  are  used  to
  77.           draw  3-D  effects.  _W_i_d_t_h specifies the width of the border
  78.           in pixels.  Geometry managers will use this  information  to
  79.           avoid   placing   any  children  of  _t_k_w_i_n  overlapping  the
  80.           outermost _w_i_d_t_h pixels of _t_k_w_i_n's area.
  81.  
  82.           The information specified in calls to TTTTkkkk____GGGGeeeeoooommmmeeeettttrrrryyyyRRRReeeeqqqquuuueeeesssstttt and
  83.           TTTTkkkk____SSSSeeeettttIIIInnnntttteeeerrrrnnnnaaaallllBBBBoooorrrrddddeeeerrrr  can  be  retrieved  using  the  macros
  84.           TTTTkkkk____RRRReeeeqqqqWWWWiiiiddddtttthhhh, TTTTkkkk____RRRReeeeqqqqHHHHeeeeiiiigggghhhhtttt, and TTTTkkkk____IIIInnnntttteeeerrrrnnnnaaaallllBBBBoooorrrrddddeeeerrrrWWWWiiiiddddtttthhhh.   See
  85.           the TTTTkkkk____WWWWiiiinnnnddddoooowwwwIIIIdddd manual entry for details.
  86.  
  87.  
  88.      KKKKEEEEYYYYWWWWOOOORRRRDDDDSSSS
  89.           geometry, request
  90.  
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.      Page 2                                          (printed 7/23/95)
  130.  
  131.  
  132.  
  133.